home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / umich / telecomm / storm100.lzh / VT100.DOC < prev    next >
Encoding:
Text File  |  1993-10-18  |  17.2 KB  |  415 lines
  1.     Storm VT100/VT102 terminal emulation
  2.  
  3. Features:
  4.     Graphics character set (line drawing)
  5.     Double-width, double-height characters
  6.     Text effects include bold, underline, inverse. (Blinking effect displayed
  7.     as 'light' characters).
  8.  
  9. Detailed specifications.
  10.  
  11. Note: Columns and rows are numbered starting at row 1, column 1 in the upper
  12. left corner.
  13.  
  14. Note: In the following table, 'Pn' indicates a numeric parameter. Numeric
  15. parameters are simply Ascii numbers that are used to modify the effect of
  16. an escape sequence. e.g. specify how many columns the cursor is to move.
  17.  
  18. If multiple numeric parameters are sent, they are separated by a semicolon.
  19. The absence of a parameter means a default value is assumed.
  20.  
  21. Scrolling regions: Under software control, a host computer can set up a
  22. region of lines as a 'scrolling region'. Control characters and escape
  23. sequences that normally cause the entire screen to scroll up or down will
  24. cause only the area of the scrolling regions to scroll up or down instead.
  25.  
  26. Character(s)    Effect
  27.  
  28. 5       ENQ. Terminal replies with Answerback string. To add an
  29.         answerback string, you need to edit the STORM.INI file to
  30.         add an entry in [VT100] of the form:
  31.         Answerback="string"
  32.         You could also use the Basic command SET
  33.         e.g. SET "STORM","VT100","Answerback","string"
  34.         The answerback string is limited to 80 characters.
  35.  
  36.         Note that answerback is disabled if the CompuServe BPLUS.TRF
  37.         file transfer module is loaded because ENQ is required for
  38.         B-PLUS file transfers.
  39.  
  40. 7       Bell. Causes a bell sound, if it's enabled by your system
  41.         setup. This is controlled by the control panel usually.
  42.  
  43. 8       Backspace. Moves the cursor to the previous column. No action
  44.         taken if the cursor is already in column 1. Backspaces are
  45.         non-destructive in VT100, though that can be overridden by
  46.         selecting "BS Erases" in the generic Terminal setup dialog.
  47.  
  48. 9        Tabs to the next tab stop. Default tab stops are every 8 columns,
  49.         starting at column 9. Tab stops can be set and cleared by the
  50.         host computer by sending the appropriate escape sequences.
  51.  
  52. 10       Line Feed. Causes the cursor to move to the next line. If the
  53.         cursor is already at the bottom of the screen or scrolling
  54.         region, scrolls the screen upwards. 'New Line' mode, if set,
  55.         causes the cursor to move to column 1 when a line feed occurs,
  56.         simulating the effect of a carriage return.
  57.  
  58. 11
  59. 12        Generate line feeds.
  60.  
  61. 13      Carriage return. Causes the cursor to move to column 1 on the
  62.         current line. A separate setting in the generic Terminal
  63.         setup dialog can add a line feed to all carriage returns
  64.         received, though that is not really a part of the VT100
  65.         emulation.
  66.  
  67. 14      Shift Out. Selects 'G1' character set. Specific
  68.         escape sequences (described later) allow you to specify what
  69.         character set is used as the G1 character set.
  70.  
  71. 15      Shift In. Selects 'G0' character set. G0 character set can
  72.         be altered by escape sequences (described later)
  73.  
  74. 27 (ESC)The escape character introduces an escape sequence, which is
  75.         used to control many terminal features.
  76.  
  77.  
  78. ESC [   CSI or Control String Introducer. Consists of the ESC
  79.         (Ascii 27) followed by a left square bracket. Indicates the
  80.         start of a category of escape sequences.
  81.  
  82. ESC D   Index. Moves the cursor to the next line, scrolling the screen
  83.         up if necessary.
  84.  
  85. ESC E   Next Line. Equivalent in effect to a Carriage Return + Line
  86.         Feed combination. Moves the cursor to the start of the next
  87.         line, scrolling the screen up if necessary.
  88.  
  89. ESC M   Reverse Index. Moves the cursor to the previous line, scrolling
  90.         the screen down if necessary.
  91.  
  92. ESC H   Sets a tab stop at the current cursor location.
  93.  
  94. ESC 7   Saves the currrent cursor location, character set, and text
  95.         effects for later restoring via the cursor restore sequence.
  96.  
  97. ESC 8   Restores a cursor state saved by a previous ESC 7 sequence.
  98.  
  99. ESC =   Sets Application Keypad mode. Causes the numeric keypad on the
  100.         ST to send special escape sequences that can be interpreted
  101.         by a host program.
  102.  
  103. ESC >   Resets keypad to normal numeric mode.
  104.  
  105. ESC c   Resets the terminal to default settings. i.e. whatever settings
  106.         you selected in the setup dialog box.
  107.  
  108.  
  109. ESC [ Pn @  Inserts the number of characters specified by the numeric
  110.             parameter at the current cursor location. Characters at the
  111.             end of the line are lost.
  112.  
  113. ESC [ Pn A  Moves the cursor up by the number of rows specified by the
  114.             numeric parameter. The cursor will not move above the top of
  115.             the screen or the top line of a scrolling region.
  116.  
  117. ESC [ Pn B  Moves the cursor down by the number of rows specified by the
  118.             numeric parameter. The cursor will not move above the bottom of
  119.             the screen or the top line of a scrolling region.
  120.  
  121. ESC [ Pn C  Moves the cursor right by the number of columns specified by
  122.             the numeric parameter. Will not move past the end of the line.
  123.  
  124. ESC [ Pn D  Moves the cursor right by the number of columns specified by
  125.             the numeric parameter. Will not move past the end of the line.
  126.  
  127. ESC [ Pn E  Moves the cursor down, as with ESC [ Pn B, but the cursor is
  128.             always repositioned to column 1.
  129.  
  130. ESC [ Pn F  Moves the cursor up, as with ESC [ Pn A, but the cursor is
  131.             always repositioned to column 1.
  132.  
  133. ESC [ Pn G  Cursor Horizontal Absolute. Moves the cursor to the column
  134.             specified by the numeric parameter.
  135.  
  136.  
  137. ESC [ Pn;Pn H  Position Cursor. Moves the cursor to the specified row and
  138. ESC [ Pn;Pn f  column. The first number is the row, the second number is the
  139.                column. Default if a parameter is absent is row/column 1.
  140.                When relative origin mode is in effect (discussed later) then
  141.                the cursor row is calculated relative to the top of the
  142.                scrolling region.
  143.  
  144. ESC [ 0 J    Clears from the current cursor location to the end of the
  145. ESC [ J      screen. Does not move the cursor.
  146.  
  147. ESC [ 1 J    Clears from the start of the screen to the current cursor
  148.              location. Does not move the cursor.
  149.  
  150. ESC [ 2 J    Clears the entire screen. Does not move the cursor.
  151.  
  152. ESC [ K      Clears from the current cursor location to the end of the line.
  153. ESC [ 0 K    Does not move the cursor.
  154.  
  155. ESC [ 1 K    Clears from the start of the line to the cursor location. Does
  156.              not move the cursor.
  157.  
  158. ESC [ 2 K    Clears the entire line that the cursor is on. Does not move the
  159.              cursor.
  160.  
  161. ESC [ Pn L   Insert Line. Inserts Pn blank lines at the current cursor
  162.              location and scrolls the rest of the screen (or scrolling
  163.              region) down.
  164.  
  165. ESC [ Pn M   Delete Line. Deletes Pn lines at the current cursor location
  166.              and scrolls the rest of the screen (or scrolling region) up.
  167.  
  168. ESC [ Pn P   Delete Character. Deletes Pn characters at the current cursor
  169.              location and shifts the line to fill in the space. Blank
  170.              characters are placed at the end of the line when characters
  171.              are deleted.
  172.  
  173. ESC [ Pn X   Erase Character. Erases Pn characters at the current cursor
  174.              location.
  175.  
  176. ESC [ c      Report Device Attributes. Responds by transmitting an escape
  177. ESC [ 0 c    sequence identifying the terminal. The default response is
  178.              "ESC[?6;2c", which is a VT102 response. This reponse can be
  179.              changed by inserting a line in the [VT100] section of the
  180.              STORM.INI file with the heading ID="(Replacement ID)".
  181.              e.g. ID="\33[1;2c" would change the reponse to a VT100 type
  182.              response.
  183.  
  184.  
  185. ESC [ g      Clear Column Tab. Clears the tab stop (if any) at the cursor
  186. ESC [ 0g     location.
  187.  
  188. ESC [ 3 g    Clear All Column Tabs. Clears all tab stops.
  189.  
  190. ESC [ Pn h   Sets various terminal modes detailed below. Note that more
  191.              than one mode can be set if multiple parameters are sent.
  192.  
  193. ESC [ 4 h    Set Insert mode. Subsequent characters are inserted at the
  194.              current cursor location and the rest of the line is scrolled
  195.              over to. Characters at the end of the line are lost.
  196.  
  197. ESC [ 12 h   Set Local Echo. Turns half duplex on.
  198.  
  199. ESC [ 20 h   Set Newline mode. Causes received Line Feed characters
  200.              (Ascii 10) to also move the cursor to the start of the line.
  201.  
  202. ESC [ Pn l   Resets the various terminal modes detailed above. Reverses the
  203.              effect of the corresponding ESC [ Pn h escape sequence. Note:
  204.              'l' is a lowercase L, not the number one '1'.
  205.  
  206. ESC [ 4 l    Set Replace mode. Subsequent characters overwrite.
  207.  
  208. ESC [ 12 l   Resets local echo. Turns full duplex on.
  209.  
  210. ESC [ 20 l   Resets Newline mode.
  211.  
  212. ESC [ Pn m   Sets/resets various character attributes used in subsequent
  213.              terminal output. Multiple parameters allow the setting of
  214.              more than one attribute in the same escape sequence.
  215.  
  216. ESC [ m
  217. ESC [ 0 m    No attributes. Turns all attributes off.
  218.  
  219. ESC [ 1 m    Set Bold attribute.
  220.  
  221. ESC [ 4 m    Set Underlined attribute.
  222.  
  223. ESC [ 5 m    Set Blinking attribute. Instead of the characters actually
  224.              blinking, this attribute is indicated by printing 'light'
  225.              characters.
  226.  
  227. ESC [ 7 m    Set Reversed attribute. Subsequent characters are displayed in
  228.              reverse video.
  229.  
  230. ESC [ 22 m   Turn Bold attribute off.
  231.  
  232. ESC [ 24 m   Turn Underlined attribute off.
  233.  
  234. ESC [ 25 m   Turn Blinking attribute off.
  235. ESC [ 27 m   Turn Reversed attribute off.
  236.  
  237. ESC [ 5 n    Report Terminal Status. Emulator responds by sending ESC [ 0 n
  238.  
  239. ESC [ 6 n    Report Cursor Location. Emulator responds by sending an
  240.              escape sequence reporting the current cursor location.
  241.  
  242. ESC [ Pn;Pn r  Set Scrolling region. The first parameter is the top of the
  243.                scrolling region, the second is the bottom. Also causes the
  244.                cursor to move to location 1,1 (either top of the scrolling
  245.                region or top of the screen, depending on origin mode).
  246.  
  247. ESC [r       Resets the scrolling region to full screen.
  248. ESC [0;0r
  249.  
  250. ESC ( 0      Sets the G0 character set as the Graphics character set.
  251.  
  252. ESC ( 1      Sets the G0 character set as the Alternate ROM character set.
  253.              This is not currently supported by the emulator, mostly to
  254.              save memory. However, it could easily be added.
  255.  
  256. ESC ( 2      Sets the G0 character set as the Alternate ROM graphics set.
  257.              This is also not currently supported by the emulator.
  258.  
  259. ESC ( A      Sets the G0 character set as the UK character set. The only
  260.              change is that '#' is replaced by the UK Pound Sterling
  261.              symbol.
  262.  
  263. ESC ( B      Sets the G0 character set as the ASCII character set. This is
  264.              the default character set.
  265.  
  266. ESC ) 0      Perform the same functions as the corresponding ESC ) escape
  267. ESC ) 1      sequences, but affect the G1 character set instead.
  268. ESC ) 2
  269. ESC ) A
  270. ESC ) B
  271.  
  272. ESC # 5      Set character width single on current line.
  273.  
  274. ESC # 6      Set double character width on current line.
  275.  
  276. ESC # 3      Set double-width/double-height character display on current
  277.              line. Displays the top half of each character as double-height
  278.              and double width. Used in conjunction with ESC # 4 to display
  279.              a line of double-height, double-width characters.
  280.  
  281. ESC # 4      Set double-width/double-height character display on current
  282.              line. Displays the bottom half of each character as
  283.              double-height and double-width.
  284.  
  285. ESC # :      Sets double-height character display on current line. Displays
  286.              the top half of each character double-height;
  287.  
  288. ESC # ;      Sets double-height character display on current line. Displays
  289.              the bottom half of each character double-height;
  290.  
  291. ESC [ ? Pn h Sets various extended terminal modes described below. Multiple
  292.              modes can be set if more than one parameter is sent.
  293.  
  294. ESC [ ? 1 h  Set cursor key Application mode. Causes the cursor keys to
  295.              send escape sequences which can be interpreted by a host
  296.              computer.
  297.  
  298. ESC [ ? 3 h  Sets 132 column mode. Currently not supported.
  299.  
  300. ESC [ ? 4 h  Sets Smooth Scroll. Not implemented.
  301.  
  302. ESC [ ? 5 h  Sets Reverse Screen. Toggles output to white characters on a
  303.         black background. Note that Storm uses white and black by
  304.         default. However you can set different colors for fore and
  305.         back colors by inserting entries in the [Terminal] section
  306.         of the STORM.INI file. The default entries are
  307.              Fore=1
  308.              Back=0
  309.         which set foreground to black, background to white. The digits
  310.         are GEM color indexes as detailed in the following table:
  311.         The number of colors supported depends on video mode. The
  312.         actual color that appears depends on how you have setup the
  313.         color palette. Setting reverse screen simply swaps foreground
  314.         and background colors.
  315.         This feature has not been testing on the Falcon or TT.
  316.  
  317.         Index    Color
  318.         ===============
  319.         0    White
  320.         1    Black
  321.         2    Red
  322.         3    Green
  323.         4    Blue
  324.         5    Cyan
  325.         6    Yellow
  326.         7    Magenta
  327.         8    White
  328.         9    Black
  329.         10    Light Red
  330.         11    Light Green
  331.         12    Light Blue
  332.         13    Light Cyan
  333.         14    Light Yellow
  334.         15    Light Magenta
  335.         16 or greater is device dependant.
  336.  
  337. ESC [ ? 6 h  Set Relative Origin Mode. Cursor positioning commands in
  338.              Relative Origin mode are relative to the top of the scrolling
  339.              region (if any) rather than the top of the screen.
  340.  
  341. ESC [ ? 7 h  Set Line Wrap. When line wrap is set, typing a character at
  342.              the end of a row will cause the cursor to move to the start
  343.              of the next line.
  344.  
  345. ESC [ ? Pn l Resets verious extended terminal modes. Has opposite effect
  346.              of corresponding Esc [ ? Pn h setting.
  347.  
  348. ESC [ ? 1 l  Resets cursor keys to normal mode.
  349. ESC [ ? 2 l  Set VT52 Mode. This will cause the emulator to switch to
  350.              emulating a VT52 terminal. To return from VT52, use the
  351.              sequence ESC < from within VT52 emulation.
  352.  
  353. ESC [ ? 3 l  Set 80 column mode. Since the emulator doesn't yet support
  354.              132 column mode, this has no effect.
  355.  
  356. ESC [ ? 4 l  Set Jump Scroll. Since smooth scroll is not supported, this
  357.              has no effect.
  358.  
  359. ESC [ ? 5 l  Set Normal Screen. Restores normal foreground and background
  360.              colors.
  361.  
  362. ESC [ ? 6 l  Reset Origin Mode. Restores absolute cursor origin mode.
  363.  
  364. ESC [ ? 7 l  Reset Line Wrap. When entering characters, the cursor will
  365.              not automatically wrap to the next line.
  366.  
  367. ESC [ ? 15 n Report Local Printer Status. No printer support at present.
  368.              The emulator responds with "ESC ? 13 n" to indicate that
  369.              no printer is present.
  370.  
  371. Other VT100 Info
  372.  
  373.     The VT100 default settings are saved in the STORM.INI file in a section
  374. labelled [VT100]. The entry Reset=00000000000 contains the settings. Each
  375. digit is a VT100 setting. Most settings are either 0 or 1. A few have
  376. larger ranges The settings are (in order)
  377.     Digit = 1            Digit = 0
  378. =================================================
  379.     Keypad Application Mode    Keypad Numeric Mode
  380.     Cursor Application Mode    Normal Cursor Mode
  381.     Relative Origin Mode    Absolute Origin Mode
  382.     Insert Mode            Overwrite Mode
  383.     New Line Mode Set        New Line Mode Reset
  384.     -----------------
  385.     G0 (can range from 0 to 3)
  386.     G1 (can range from 0 to 3)
  387.     Current Selected Set. 0 or 1 at present, indicating G0 (0) or G1 (1). In
  388. future this could change to 0 to 3 if support for four character sets is
  389. added.
  390.     -----------------
  391.     Line Wrap On        Line Wrap Off
  392.     Destructive Backspace    Non-Destructive Backspace
  393.     ReverseVideo        Normal Video
  394.  
  395. Note that this includes extra settings not available from the setup dialog.
  396. When the ESC c sequence is received and the terminal is reset, these values
  397. are used in resetting the terminal. This is useful if you want a particular
  398. setup to be retained when the terminal is reset. e.g. keypad application mode
  399. to remain set.
  400.  
  401.  
  402. I should note that Line Wrap, Destructive Backspace, and Reverse Video are
  403. actually part of the general terminal setup. They are included here in order
  404. to be able to override the general terminal settings when resetting the
  405. VT100 terminal. When you use the VT100 setup dialog, the current state of
  406. these three settings are automatically saved in the VT100 Reset setting.
  407.  
  408. Note: Setting the VT100 New Line mode alters the general terminal settings to
  409. set Add Linefeeds Inbound in addition to the VT100 New Line setting. If you
  410. have New Line selected in VT100, but Add Linefeeds Inbound is not selected
  411. in the general terminal setup, then loading VT100 will automatically set
  412. Add Linefeeds Inbound.
  413.  
  414.  
  415.